home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Amiga Amateur Radio User Group / AARUG UK #81 (199x)(Amiga Amateur Radio User Group UK)(PD)[WB][G4DCV].zip / AARUG UK #81 (199x)(Amiga Amateur Radio User Group UK)(PD)[WB][G4DCV].adf / DisView / ATTACH < prev    next >
Text File  |  1995-05-29  |  9KB  |  234 lines
  1. ======                                              DISview [518]
  2. attach
  3. ======
  4.  
  5.  
  6. This section details the 'attach' commands for the various
  7. hardware and software interface drivers.  A list of the
  8. available types on a particular release may be obtained with the
  9. 'attach ?' command.
  10.  
  11. Some parameters are accepted by several drivers. They are:
  12.  
  13. ----------------
  14. <rx_buffer_size>
  15. ----------------
  16. For asynchronous devices (e.g. COM ports operating in SLIP/PPP
  17. mode) this parameter specifies the size of the receiver's ring
  18. buffer.  It should be large enough to hold incoming data at full
  19. line speed.
  20.  
  21. Another important consideration is that the more recent versions
  22. of NET improve interrupt response by maintaining a special pool
  23. of buffers for use by the receive routines. This limits 
  24. <rx_buffer_size>; in fact, attempting to set a larger value may
  25. cause the driver not to work at all.  This situation can be
  26. detected by giving the 'memory status' command and looking for
  27. non-zero count of "Ibuffail" events, although these events can
  28. also occur occasionally during normal operation.
  29.  
  30.  
  31. -----------
  32. <interface>
  33. -----------
  34. The name to be assigned to this interface. It is an arbitrary
  35. character string, and is used to refer to the interface by 
  36. many commands, including:
  37.  
  38.   attach    detach    dialer   ifconfig   ip filter 
  39.   param     ppp       tip      trace 
  40.  
  41. In Demon's NET distribution, the standard interface name for 
  42. a COM port is 'sl0' (i.e. letter "ess", letter "ell", digit 
  43. zero), standing for 'serial link zero'. (N.B. the interface
  44. name need not relate directly to the COM port number -- for
  45. example, 'sl0' could refer to COM1 or COM2 or COM3, etc).
  46.  
  47.  
  48. -----------
  49. <ioaddress>
  50. -----------
  51. The base address of the interface's control registers, in
  52. hexadecimal.
  53.  
  54.  
  55. --------
  56. <vector>
  57. --------
  58. The interface's hardware interrupt (IRQ) vector, in hexadecimal.
  59.  
  60.  
  61. Standard values for serial ports on the IBM PC and clones for 
  62. <ioaddress> and <vector> are as follows:
  63.  
  64.             <ioaddress>  <vector>
  65.             -----------  --------
  66.      COM1:     0x3f8        4
  67.      COM2:     0x2f8        3
  68.      COM3:     0x3e8        4
  69.      COM4:     0x2e8        3
  70.  
  71. If the port uses a 16550A chip, it will be detected 
  72. automatically and the FIFOs enabled.
  73.  
  74.  
  75. -----
  76. <mtu>
  77. -----
  78. The Maximum Transmission Unit (MTU) size, in bytes.  Datagrams
  79. larger than this limit will be fragmented at the IP layer into
  80. smaller pieces.
  81.  
  82. IP-level fragmentation often makes it possible to interconnect
  83. two dissimilar networks, but it is best avoided whenever
  84. possible.  One reason is that when a single IP fragment is lost,
  85. all other fragments belonging to the same datagram are
  86. effectively also lost and the entire datagram must be
  87. retransmitted by the source.
  88.  
  89. Even without loss, fragments require the allocation of temporary
  90. buffer memory at the destination, and it is never easy to decide
  91. how long to wait for missing fragments before giving up and
  92. discarding those that have already arrived.  A reassembly timer
  93. controls this process.  (See the 'ip rtimer' command).
  94.  
  95. Most subnetworks that carry IP have MTUs of 576 bytes or more, so
  96. interconnecting them with subnetworks having smaller values can
  97. result in considerable fragmentation.  For this reason, IP
  98. implementors working with links or subnets having unusually small
  99. packet size limits are encouraged to use transparent
  100. fragmentation, that is, to devise schemes to break up large IP
  101. datagrams into a sequence of link or subnet frames that are
  102. immediately reassembled on the other end of the link or subnet
  103. into the original, whole IP datagram without the use of IP-level
  104. fragmentation.
  105.  
  106. Each fragment of a datagram has its own IP header, and is handled
  107. by the network as if it were a distinct IP datagram.  When it
  108. arrives at the destination it is held by the IP layer until all
  109. the other fragments belonging to the original datagram have
  110. arrived.  Then they are reassembled back into the complete,
  111. original IP datagram.
  112.  
  113. The minimum acceptable interface MTU is 28 bytes: 20 bytes for
  114. the IP header, plus 8 bytes of data.
  115.  
  116. There is no default MTU in NET; it must be explicitly specified
  117. for each interface as part of the 'attach' command.
  118.  
  119. TCP/IP header overhead considerations apply when choosing an MTU.
  120. However, certain subnetwork types supported by NET have well-
  121. established MTUs, and these should always be used unless you know
  122. what you're doing.  The recommended MTUs for these network types
  123. are:
  124.  
  125. Ethernet: 1500 bytes
  126. ARCNET:   508 bytes
  127. PPP:      The MTU for PPP is automatically negotiated, and
  128.           defaults to 1500 bytes.
  129.  
  130. Other subnet types, including SLIP, are not as well 
  131. standardized.
  132.  
  133. SLIP:   Has no official MTU, but the most common implementation
  134. (for BSD UNIX) uses an MTU of 1006 bytes.  Although NET has no
  135. hard-wired limit on the size of a received SLIP frame, this is
  136. not true for other systems.  Interoperability problems may
  137. therefore result if larger MTUs are used in NET.
  138.  
  139.  
  140. -------
  141. <speed>
  142. -------
  143. The speed on the NET serial link (e.g. between the computer
  144. running NET and the modem) in bits per second (e.g. 38400).
  145.  
  146. For more information on setting appropriate parameters, consult
  147. the Tuning KA9Q FAQ.
  148.  
  149. -------
  150. <flags>
  151. -------
  152. A number of options may be added to 'attach' commands:
  153.  
  154.   'f' forces async handler to assume 16550A UART
  155.   'n' no TX flow control
  156.  
  157. If more than one flag is used, they should be concatenated. Use
  158. of these flags is not recommended.  If you do not understand the
  159. circumstances when they should be used then you should not use 
  160. them.  In particular, if you find that you need to use the 'n'
  161. flag then you should actually be fixing your modem's 
  162. configuration so that you can use TX handshake.  Otherwise, 
  163. performance will almost certainly be impaired.
  164.  
  165.  
  166. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  167.  
  168. Generic 'attach asy' command:
  169. _________________________________________________________________
  170. attach asy <ioaddress> <vector> ppp | slip  <interface>
  171.                   <rx_buffer_size> <mtu> <speed> [<flags>]
  172. _________________________________________________________________
  173. Attach a standard PC COM port, using the 8250 or 16550A chip.  
  174.  
  175.  
  176.  
  177. _________________________________________________________________
  178. attach asy <ioaddress> <vector> ppp <interface>
  179.                   <rx_buffer_size> <mtu> <speed> [<flags>]
  180. _________________________________________________________________
  181. Point-to-Point-Protocol.  Encapsulates datagrams in an HDLC-like
  182. frame. 
  183.  
  184. >> Example: attach asy 0x3f8 4 ppp sl0 4096 1500 38400
  185.             attach asy 0x3f8 4 ppp sl0 4096 1500 38400 fn
  186.                                                        ||
  187.                                    not recommended -----
  188.  
  189. _________________________________________________________________
  190. attach asy <ioaddress> <vector> slip <interface> 
  191.                   <rx_buffer_size> <mtu> <speed> [<flags>]
  192. _________________________________________________________________
  193. Serial Line Internet Protocol.  Encapsulates IP datagrams
  194. directly in SLIP frames without a link header.  This is for
  195. operation on point-to-point lines and is compatible with 4.2BSD
  196. UNIX SLIP.
  197.  
  198.  
  199. >> Example:  To attach the COM1 port to operate in point-to-point
  200. slip mode at 9600 baud, calling it 'sl0'.  A 1024-byte receiver
  201. ring buffer is allocated.  Outgoing packets larger than 256 bytes
  202. are fragmented.  RTS/CTS and carrier detection are used, together
  203. with header compression:
  204.  
  205.            attach asy 0x3f8 4 slip sl0 1024 256 9600 crv
  206.  
  207.  
  208.  
  209. _________________________________________________________________
  210. attach packet <vector> <interface> <txqlen> <mtu>
  211. _________________________________________________________________
  212. Driver for use with separate software packet drivers meeting the
  213. Packet Driver specification from FTP Software Inc.  The driver
  214. must have already been installed before the 'attach' command is
  215. given.  
  216.  
  217. <vector> is the software interrupt vector used for communication
  218. to the packet driver, and <txqlen> is the maximum number of
  219. packets that will be allowed on the transmit queue.
  220.  
  221. >> Example:  In AUTOEXEC.BAT, the driver for a Western Digital
  222. WD8003E Ethernet adapter can be installed with the command:
  223.  
  224.      WD8003E 0x60 2 0x240 0xd000
  225.  
  226. This means that the adapter uses software interrupt vector 0x60,
  227. IRQ 2, I/O address 0x240 and RAM base address 0xd000.
  228.  
  229. Then the NET packet driver can be attached to the adapter driver
  230. with the command (in AUTOEXEC.NET):
  231.  
  232.      attach packet 0x60 en0 8 1500
  233.  
  234.